home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 9 / QRZ Ham Radio Callsign Database - Volume 9.iso / pc / files / mac / softkiss.txt < prev    next >
Text File  |  1996-06-24  |  4KB  |  96 lines
  1. Softkiss is a device driver/control panel for the macintosh.  It lets
  2. you use a cheap modem to get your mac on packet.  See oct 92 edition
  3. of 73 magazine for more details. Softkiss was written by
  4. Aaron Wohl (n3liw+@cmu.edu).  The major changes since 1.2.x are, support
  5. for kiss parameter changes and fixes/debugging support for a lockup
  6. problem.
  7.  
  8. Jim Van Peursem (jvp@cpre1.ee.iastate.edu) just started shipping savant.
  9. It is an all new mac program to do ax25 connections with a tnc in
  10. kiss mode.  I switched to using savant from macnet and like it a lot.
  11.  
  12. Softkiss is available via anonymous ftp from host
  13. akutaktak.andrew.cmu.edu [128.2.35.1].
  14.  
  15. /aw0g/softkiss.1.8.sit.hqx       - Get this to run softkiss
  16. /aw0g/softkiss.src.1.8.sit.hqx   - Get this to modify softkiss sources
  17.  
  18. *** I recieved zillions of mail messages about softkiss and 
  19. *** suggested changes to the user manua.  I am
  20. *** only now digging out of the pile sorry for the delay
  21.  
  22. Changes in 1.6 March 20 1993
  23.   Allow numbers to be type in as hex eg $a
  24.   Rewrite transmit interupt handling
  25.   Have scc abort outgoing packet if interupts are off for two long
  26.       Variable xmit_overrun displays the number of times this has happened
  27.   Fix debug output code to handle large monitors
  28.   Fix: Sometimes kiss mode wouldn't work unless tnc mode was used first
  29.   Copy 8530.h from KA9Q's nos to get nice names for the scc registers/values
  30.  
  31.   Users have reported lockups after running SoftKiss for a while.
  32.   The SE/30 and FX I work on don't lock up for me.   I rewrote some of
  33.   the interupt code mentioned above and enabled the debug command described bellow.
  34.   Hopefully the lockup problem is fixed, if not turn on debugging and let me know
  35.   what you see when it locks up.  Perhaps it is still getting interupts (perhaps
  36.   continously causing the lockup).
  37.  
  38.   Enable debug command, used as debug_level 1
  39.     Only turn debugging if the primary monitor is in two bit mode
  40.     With debugging on the driver writes output to the screen memory from
  41.       interupt level.  Move your windows over to the right so you can read
  42.       the softkiss output.
  43.     Each softkiss channel has it's own area of the screen for output.
  44.     As the finite state machine changes state the state numbers are written
  45.         out.  State numbers:
  46.             0 port offline
  47.             1 RX mode
  48.             2 RX of packet in progress
  49.             3 RX but throw away data
  50.             4 waiting for dwait/slottime to expire
  51.             5 keying up, sending flags
  52.             6 transmiting
  53.             7 sending trailer
  54.     On an external/status interupt the active status info is written out:
  55.         a - abort
  56.         u - transmit underrun
  57.         c - cts (carrier detect on HSKi input)
  58.         h - hunt mode fount sync character
  59.         d - DCR input (GPI input or mouse on mac+ or ...)
  60.         z - Zero count in baud rate generator
  61.     On a recieve interupt the recieved character is written out
  62.     On a transmit interupt the sent character is written out
  63.     On a special interupt 'S' is written out
  64.  
  65.     If you are changing the SoftKiss sources you will need to make
  66.     a StrictMacHeaders file.  Copy the "Mac #includes.c" file that comes
  67.     with think c and in the line:
  68. #define SIMPLIFY_PROTOTYPES        1
  69.     change the 1 to a zero.  Use the "Preproces..." command from the source
  70.     menu and save the result in the same folder as MacHeaders but call
  71.     it StrictMacHeaders.  When softkiss is built this is used to be as picky
  72.     as possible in reporting type mismatches.
  73.  
  74.     If you are adding new commands to softkiss let me know, it pretty
  75.     strange right now and I haven't documented it.
  76.  
  77. Wish list:
  78. Finish updates to manual
  79. Comm toolbox support
  80. Finish single character foreign language support
  81. Finish digipeat and cross channel digipeat
  82. Finish .ax25_packet driver interface
  83.  
  84. Changes in 1.4
  85.  Support kiss commands for savant
  86.  
  87. Changes in 1.2.3a0
  88. Users where running macnet then trying to run an emulator at the same time.
  89.   So if a serial port is already open refuse to open again.
  90. Check the port in use bytes sooner so we don't fight with appletalk.
  91. Partial foriegn language support, move all strings from driver to resource.
  92.  
  93. Changes in 1.2.2a0
  94. Add a wireing diagram for Tigertronics BayPac modem
  95. Fix DCD interupt handling so the mouse works on a mac+
  96.